home *** CD-ROM | disk | FTP | other *** search
/ Amiga Game-Power / Amiga Game-Power.iso / pd mix ii / ami gazer / conman / sideshow.doc < prev    next >
Text File  |  1994-05-20  |  3KB  |  57 lines
  1. **************************     SideShow     ****************************
  2.  
  3. SideShow is a simple utility for use with the ConMan console handler.  It
  4. allows one or more "scratchpad" windows to be used to prepare commands for
  5. a host window; the commands are then slipped into the main command stream
  6. using a special "backdoor" mechanism implemented in the console handler.
  7.  
  8. Operation.
  9. Any number of "SideShow" windows may be opened by entering "run sideshow"
  10. from a command window.  Commands may then be entered and edited in the
  11. new window using the usual ConMan editing facilites.  Once the desired
  12. command or data sequence has been prepared, hit F8 to submit it to the 
  13. host's stream.  The host window need not be active to receive the command 
  14. stream; it may may be sitting in the background somewhere. The close
  15. gadget or F3 may be used to exit at any time.
  16.  
  17. An alternate window definition may be specified as a command-line argument.
  18. For example, "run sideshow con:////BigGuy/c" specifies a full-screen window
  19. with a close gadget.
  20.  
  21. Note:  SideShow requires version V0.98B or later of ConMan; if used with a
  22. prior version or with a normal DOS window, an error message will be displayed 
  23. whenever an attempt is made to transmit a sequence of commands.
  24.  
  25.  
  26. Principles of Operation.
  27. SideShow uses a special packet type called "ACTION_MERGE" which has been
  28. implemented in the ConMan console handler.  This packet takes the same
  29. parameters as a "write" packet, but causes the data to be entered into
  30. the input stream, just as though it had been entered at the keyboard.  
  31. The stream is edited in exactly the same fashion as actual keyboard input
  32. input, so control sequences may be included for special effects.
  33.  
  34. This program serves as an example of function-key interrupt processing
  35. using the ConHandler library functions.  In this case the keys of interest
  36. are F3, F8, and HELP; the "close gadget" event is also checked, but is
  37. passed back to the console handler rather than being trapped.  The assembler 
  38. source code for "SideShow" has been included.
  39.  
  40. 'C' programmers should note that the event handler function may be written
  41. entirely in 'C', as the arguments are available on the stack as well as in 
  42. registers.  I haven't yet had time to write the binding functions for the 
  43. library calls, though.
  44.  
  45. Distribution.
  46. This program is to be distributed as shareware to Amigoid life-forms 
  47. everywhere!  Make sure your friends get a copy.  Comments and contributions
  48. will be appreciated and may be sent to:
  49.  
  50.       William S. Hawes        (bix: whawes)
  51.       P.O. Box 308
  52.       Maynard, MA 01754
  53.       (617) 568-8695
  54.  
  55.                                     -- WSH (May 10, 1987)
  56.  
  57.